home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 001-025 / scopedisk7 / unix / shar.doc < prev    next >
Text File  |  1995-03-18  |  2KB  |  56 lines
  1.  
  2.  SHAR(1net)UNIX Programmer's Manual (December 26, 1984) SHAR(1net)
  3.  
  4.  NAME
  5.         shar - create file storage archive for extraction by /bin/sh
  6.  
  7.  SYNOPSIS
  8.         shar [-d delim] [-p prefix] [-bcv] files
  9.  
  10.  DESCRIPTION
  11.         SHAR prints its input files with special lines around them to be
  12.         used by the shell, bin/msh , to extract them later.  The output can
  13.         be filtered through the shell to recreate copies of the original files.
  14.  
  15.         Options
  16.           -a   All the options.  The options:
  17.                                    -v -c -b -p XX
  18.                are implied.
  19.  
  20.           -v   Print verbose feedback messages about what shar is
  21.                doing to be printed during extraction.  Sizes of plain
  22.                files are echoed to allow a simple validity check.
  23.  
  24.           -c   Check file size on extraction by counting characters.
  25.                An error message is reported to the person doing the
  26.                extraction if the sizes don't match.
  27.  
  28.           -b   Extract files into basenames so that files with
  29.                absolute path names are put into the current directory.
  30.                This option has no effect when directories are
  31.                archived.
  32.  
  33.           -d delim
  34.                Use this as the ``end of file'' delimiter instead of
  35.                the default.  The only reason to change it is if you
  36.                suspect an file contains the default delimiter: SHAR_EOF
  37.  
  38.           -p prefix
  39.                Use this as the prefix to each line of the archived
  40.                files.  This is to make sure that special characters
  41.                are not eaten up by programs like mailers.  If this
  42.                option is used, the files will be extracted with the
  43.                stream editor sed rather than cat so it is more
  44.                efficient and portable to avoid setting the prefix.
  45.  
  46.         SHAR allows directories to be named, and SHAR prints the
  47.         necessary commands to create new directories and fill them.
  48.  
  49.  AUTHOR
  50.         Gary Perlman (based on a shell version by James Gosling)
  51.         (many additions motivated by Derek Zahn & Michael Thompson)
  52.  
  53.  BUGS
  54.         SHAR does not know anything about:  links between files, binary files,
  55.         overwriting existing files, or protection modes of files.
  56.